home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / COMMADIO / SAPPHIRE.LZH / SAPPHA.ZIP / SAPPHTS.DOC < prev    next >
Text File  |  1992-10-06  |  29KB  |  608 lines
  1. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  2. █ HOW TO USE THIS TROUBLE-SHOOTING GUIDE                                       █
  3. █──────────────────────────────────────────────────────────────────────────────█
  4. █                                                                              █
  5. █ This guide is contained in the file  SAPPHTS.DOC.  You can print it out, but █
  6. █ it works best if you view it via the SYSOP menu, which uses our SEE program. █
  7. █ To do that, enter SYSOP at the DOS prompt, select INFO, then select TROUBLE. █
  8. █ This lets you search the guide for keywords whenever you have a problem.     █
  9. █                                                                              █
  10. █ Each problem described in this file is  preceded by a list of keywords, each █
  11. █ of which is preceded by  a slash character  (/).   Thus,  if you had a modem █
  12. █ problem, you could press "F" (for Find) then search for  /MODEM.  By repeat- █
  13. █ edly searching  for  /MODEM  (press  F3  after  the initial search)  you can █
  14. █ quickly scan the file for any related problems.                              █
  15. █                                                                              █
  16. █ When in doubt about  which keyword to choose,  use the shortest one that can █
  17. █ describe your problem.  For example,  if a user has trouble connecting, look █
  18. █ for /CONNECT rather than /CONNECTION PROBLEM,  since /CONNECT would match on █
  19. █ /CONNECT or /CONNECTING or /CONNECTION and so on.  Most important, avoid any █
  20. █ plurals:  search for /MODEM, not /MODEMS.                                    █
  21. █                                                                              █
  22. █ You can also search major categories.  See the INDEX section, below.         █
  23. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  24.  
  25.  
  26. ████████████████████████████████████████████████████████████████████████████████
  27. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  28. █░▒░▒░▒░▒░▒░▒▌                    == INDEX ==                     ▐▒░▒░▒░▒░▒░▒░█
  29. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  30. ████████████████████████████████████████████████████████████████████████████████
  31.  
  32.  
  33.   Major categories in this guide are presented in alphabetical order, as
  34.   follows:
  35.  
  36.   ■ COMMANDS (STANDARD)
  37.   ■ COMMANDS (SYSOP)
  38.   ■ DISPLAY
  39.   ■ DOORS  
  40.   ■ EVENTS
  41.   ■ FILE TRANSFER
  42.   ■ FRONT END
  43.   ■ INPUT
  44.   ■ MAINTENANCE
  45.   ■ MESSAGES
  46.   ■ MODEM
  47.   ■ NOISE
  48.   ■ PROGRAM FAILURE
  49.  
  50.   Specific headings are preceded by two equals signs and a blank (see INDEX
  51.   heading, above).  Thus, to find the NOISE section, press F for Find, type
  52.   "==", then a blank, then "NOISE".
  53.  
  54.  
  55.  
  56. ████████████████████████████████████████████████████████████████████████████████
  57. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  58. █░▒░▒░▒░▒░▒░▒▌             == COMMANDS (STANDARD) ==              ▐▒░▒░▒░▒░▒░▒░█
  59. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  60. ████████████████████████████████████████████████████████████████████████████████
  61.  
  62.  
  63. KEYWORD:  /COMMANDS/SET/NAMES/TEXT
  64. PROBLEM:  How do SET, NAMES or TEXT work?
  65.  
  66. These commands "tune" other commands to restrict or control what they report.
  67. SET controls them by time, NAMES by the name of the person or file being
  68. referenced, and TEXT by any text (apart from name-oriented text) that might
  69. be presented by the command.
  70.  
  71.  
  72.  
  73. ████████████████████████████████████████████████████████████████████████████████
  74. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  75. █░▒░▒░▒░▒░▒░▒▌              == COMMANDS (SYSOP) ==                ▐▒░▒░▒░▒░▒░▒░█
  76. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  77. ████████████████████████████████████████████████████████████████████████████████
  78.  
  79.  
  80. KEYWORD:  /COMMANDS/USERS/CLEAN/CLEAN-UP/CLEANUP
  81. PROBLEM:  How do I access clean-up mode?
  82.  
  83. To clean up the user list, you have to be in UltraMode (turned on and off with
  84. Alt-F10).  Once you're in UltraMode, select the USERS command.
  85.  
  86.  
  87.  
  88. ████████████████████████████████████████████████████████████████████████████████
  89. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  90. █░▒░▒░▒░▒░▒░▒▌                   == DISPLAY ==                    ▐▒░▒░▒░▒░▒░▒░█
  91. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  92. ████████████████████████████████████████████████████████████████████████████████
  93.  
  94.  
  95. KEYWORD:  /SEE/VIEW/43/50/EGA/VGA
  96. PROBLEM:  When viewing text files with SEE, I no longer switch to 43- or
  97.           50-line mode
  98.  
  99. The version of SEE that accompanies Sapphire is a custom version designed for
  100. Sapphire.  If you find a more recent version of SEE, don't install it in your
  101. Sapphire directory.
  102.  
  103.  
  104.  
  105. ████████████████████████████████████████████████████████████████████████████████
  106. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  107. █░▒░▒░▒░▒░▒░▒▌                    == DOORS ==                     ▐▒░▒░▒░▒░▒░▒░█
  108. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  109. ████████████████████████████████████████████████████████████████████████████████
  110.  
  111.  
  112. KEYWORD:  /DOORS/OTHER BBS/INTERFACE
  113. PROBLEM:  How do I use doors that weren't specifically designed for Sapphire?
  114.  
  115. Several interface programs are available which will interface doors for one BBS
  116. to another BBS.  For example, the shareware programs SP2QBBS and DOORMASTER can
  117. be used.  Both of these programs may be obtained from our support system.  If
  118. you use them, please support the author's efforts by registering them.
  119.  
  120. ───────────────────────────────────────────────────────────────────────────────
  121.  
  122. KEYWORD:  /DOORS/REMOTE
  123. PROBLEM:  The door comes up but the users don't see anything
  124.  
  125. Here are a few things to check out:
  126.  
  127. 1.  Are you running a "FOSSIL" driver?  If so, why?  Does the door NEED the
  128.     fossil?  Can you disable the fossil when it's not being used?  If the door
  129.     documentation doesn't explicitly say that it needs a fossil driver, try
  130.     removing the fossil COMPLETELY before trying the door (i.e. reboot and
  131.     don't install it).  Then, if that proves that the fossil was the cause of
  132.     the problem, read the fossil documentation to see if there is some way to
  133.     disable the fossil when it is not needed.
  134.  
  135. 2.  Does the door know which port it is supposed to be using?  You may have to
  136.     use a door interface program (described above) to let it know.
  137.  
  138. 3.  Some programs (such as Pinnacle Software's Pyroto Mountain program) can
  139.     accept the port information on the command line, in which case you should
  140.     make sure that you are not pointing at the console.  Taking Pyroto as an
  141.     example, if the command line specifies a port of 0 (zero), it means the
  142.     console.  If it specifies a port address, it means the serial port.
  143.  
  144. ───────────────────────────────────────────────────────────────────────────────
  145.  
  146. KEYWORD:  /DOORS/RETURN
  147. PROBLEM:  How does Sapphire know we are coming back from a door?
  148.  
  149. When Sapphire creates the batch file EXTERNAL.BAT, it writes the part where it
  150. starts itself back up as follows:
  151.  
  152.   SAPPHIRE DOOR
  153.  
  154. This lets Sapphire know that it should not initialize the modem.
  155.  
  156.  
  157.  
  158. ████████████████████████████████████████████████████████████████████████████████
  159. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  160. █░▒░▒░▒░▒░▒░▒▌                    == EVENTS ==                    ▐▒░▒░▒░▒░▒░▒░█
  161. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  162. ████████████████████████████████████████████████████████████████████████████████
  163.  
  164.  
  165. KEYWORD:  /EVENTS/RETURN
  166. PROBLEM:  How does Sapphire know we are coming back from a event?
  167.  
  168. When Sapphire creates the batch file EXTERNAL.BAT, it writes the part where it
  169. starts itself back up as follows:
  170.  
  171.   SAPPHIRE EVENT
  172.  
  173. This lets Sapphire know that it should not initialize the modem.
  174.  
  175.  
  176.  
  177. ████████████████████████████████████████████████████████████████████████████████
  178. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  179. █░▒░▒░▒░▒░▒░▒▌                == FILE TRANSFER ==                 ▐▒░▒░▒░▒░▒░▒░█
  180. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  181. ████████████████████████████████████████████████████████████████████████████████
  182.  
  183.  
  184. KEYWORD:  /DOWNLOAD/UPLOAD/ABORTS
  185. PROBLEM:  File transfer aborts immediately
  186.  
  187. Here are a few things to check out:
  188.  
  189. 1.  Are you running a "FOSSIL" driver?  If so, see the discussion of fossils
  190.     in the DOORS section.
  191.  
  192. 2.  If you are running on COM3 or COM4, you must tell DSZ this by specifying
  193.     the DSZPORT parameter.  For example, if you are on COM3, you would have
  194.     to enter the DOS command SET DSZPORT=3.  The DSZ manual explains more.
  195.  
  196.  
  197.  
  198. ████████████████████████████████████████████████████████████████████████████████
  199. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  200. █░▒░▒░▒░▒░▒░▒▌                  == FRONT END ==                   ▐▒░▒░▒░▒░▒░▒░█
  201. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  202. ████████████████████████████████████████████████████████████████████████████████
  203.  
  204.  
  205. KEYWORD:  /FRONT END/FIDO/NETWORK
  206. PROBLEM:  Does Sapphire support Fido or other networks?
  207.  
  208. Not at the moment.  We are looking into the possibility of creating a truly
  209. maintenance-free network.  We have heard from some Fido sysops that they spend
  210. up to 3 hours a week keeping their Fido system up to date.  This is not in keep-
  211. ing with the "install and forget" design of Sapphire.
  212.  
  213. ───────────────────────────────────────────────────────────────────────────────
  214.  
  215. KEYWORD:  /FRONT END/INSTALL
  216. PROBLEM:  How do you install a front-end program (to answer the modem)?
  217.  
  218. Another program can call Sapphire with the command:
  219.  
  220.   SAPPHIRE FRONT <baudrate>
  221.  
  222. This will start up Sapphire without touching the modem.  If the baudrate is 0
  223. (zero) or omitted, it means that the user is at the console.
  224.  
  225.  
  226.  
  227. ████████████████████████████████████████████████████████████████████████████████
  228. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  229. █░▒░▒░▒░▒░▒░▒▌                    == INPUT ==                     ▐▒░▒░▒░▒░▒░▒░█
  230. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  231. ████████████████████████████████████████████████████████████████████████████████
  232.  
  233.  
  234. KEYWORD:  /USER/ENTER/INPUT/FREEZE
  235. PROBLEM:  User has to press Enter twice after each input.
  236.  
  237. The symptom is that the user will type some input, hit Enter, and the cursor
  238. will "freeze" in column one -- before doing a linefeed -- and will not move
  239. on until he hits another character.
  240.  
  241. This happens when the user sets his terminal program to send a CTRL-S whenever
  242. he presses Enter.  For some reason, some Macintosh terminal programs seem to
  243. come pre-configured this way.
  244.  
  245. Over the phone, it is very difficult to explain to a user how to solve this
  246. problem.  In brief, however, he should look through his terminal program's
  247. configuration section for something labelled "handshaking" or "ASCII protocol",
  248. or something like that, and disable handshaking there.
  249.  
  250. ───────────────────────────────────────────────────────────────────────────────
  251.  
  252. KEYWORD:  /USER/INPUT/CHARACTERS/MISSING
  253. PROBLEM:  Some of the characters the user types are lost.
  254.  
  255. Sapphire can have problems with multi-tasking software such as DesqView.  The
  256. Sapphire serial routines are poll-driven rather than interrupt-driven.  What
  257. this means is that, if you're running multi-tasking software, your users may
  258. lose characters when they type.
  259.  
  260. Poll-driven I/O offers total port compatibility with all hardware platforms
  261. upon which Sapphire is likely to be run, but it does make it inappropriate for
  262. multi-tasking machines.
  263.  
  264.  
  265.  
  266. ████████████████████████████████████████████████████████████████████████████████
  267. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  268. █░▒░▒░▒░▒░▒░▒▌                 == MAINTENANCE ==                  ▐▒░▒░▒░▒░▒░▒░█
  269. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  270. ████████████████████████████████████████████████████████████████████████████████
  271.  
  272. ╔══════════════════════════════════════════════════════════════════════════════╗
  273. ║ SEE ALSO:  COMMANDS (SYSOP)                                                  ║
  274. ╚══════════════════════════════════════════════════════════════════════════════╝
  275.  
  276. KEYWORD:  /FILE LIST/FULL/DISK/SPACE
  277. PROBLEM:  File list is full
  278.  
  279. In most cases, the file list is self-maintaining, but if ALL of the files have
  280. been on the list for less than 14 days, auto-maintenance is disabled.
  281.  
  282. When this happens, you can manually delete some files, using the FILES command
  283. (when logged in at user level 8), or you can wait for a few days for some files
  284. to time out.
  285.  
  286.  
  287.  
  288. ████████████████████████████████████████████████████████████████████████████████
  289. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  290. █░▒░▒░▒░▒░▒░▒▌                  == MESSAGES ==                    ▐▒░▒░▒░▒░▒░▒░█
  291. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  292. ████████████████████████████████████████████████████████████████████████████████
  293.  
  294.  
  295. KEYWORD:  /MESSAGES/READING/MISSING/NEW
  296. PROBLEM:  The number of "new" messages reported is different from what is
  297.           actually shown.
  298.  
  299. 1.  If the message just before the first one in that message base is yours,
  300.     yours will be diplayed, in order to put the replies in context.  This is
  301.     not, however, a "new" message, so it isn't counted.
  302.  
  303. 2.  Messages with no viewable text (or just the summary line viewable) due to
  304.     use of <<privates>> or ><exclusives>< are not displayed, though they are
  305.     counted in the "new" messages.  (It would take too long for Sapphire to
  306.     look at each message in the message base, in advance, to see which ones 
  307.     are visible.)
  308.  
  309. 3.  If you physically delete message files (instead of using the ERASE 
  310.     command), Sapphire will keep them listed in the message file, but won't
  311.     be able to open the file when it is time to display it.
  312.  
  313.  
  314.  
  315. ████████████████████████████████████████████████████████████████████████████████
  316. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  317. █░▒░▒░▒░▒░▒░▒▌                    == MODEM ==                     ▐▒░▒░▒░▒░▒░▒░█
  318. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  319. ████████████████████████████████████████████████████████████████████████████████
  320.  
  321.  
  322. ▄█▀█▀█▀█▀█▀█▀█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█▀█▀█▀█▀█▀█▀█▄
  323. █▌▒■▒■▒■▒■▒■▒■                  = CONNECTING =                    ■▒■▒■▒■▒■▒■▒▐█
  324. ▀█▄█▄█▄█▄█▄█▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▄█▄█▄█▄█▄█▄█▀
  325.  
  326.  
  327. KEYWORD:  /MODEM/ANSWER/CONNECTING/CALL
  328. PROBLEM:  Modem doesn't answer incoming calls.
  329.  
  330. This happens if the modem is not configured correctly, either in hardware or
  331. modem settings.  Check all of the following suggestions; one of them may solve
  332. your problem.
  333.  
  334. ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  335. HARDWARE PROBLEMS
  336. ···············································································
  337.  
  338. 1.  If, when you start up Sapphire, it does NOT have an error-free dialog
  339.     with the modem (i.e. if it complains about a carrier, or modem not
  340.     ready, or if the modem never responds "OK"), refer to the trouble-
  341.     shooting section concerned with those problems (do a keyword search for
  342.     (slash)CARRIER, (slash)NOT READY or (slash)OK).
  343.  
  344. 2.  If you have an external modem (a box outside your computer, as opposed
  345.     to a card inside your computer), check the following:
  346.  
  347.     A.  Is your modem plugged in?  (Are lights glowing on the front panel?)
  348.  
  349.     B.  Is the modem plugged into the phone line?
  350.  
  351.     C.  Is the phone line plugged into the CORRECT plug on the modem?
  352.         (Some modems have one plug for the line and one for a handset)
  353.  
  354. 3.  As an aid to understanding the problem, try calling the modem on a voice
  355.     phone.  Does it pick up the line?  If it does pick up the line, do you
  356.     hear a carrier?
  357.  
  358. ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  359. MODEM SETTINGS
  360. ···············································································
  361.  
  362. 1.  If you have an external modem, it may have some lights which indicate how
  363.     it is set, or what signals it is receiving.  Check these lights and
  364.     settings, and compare them with the informatin in your modem manual.
  365.  
  366.     LIGHT                  USUALLY AFFECTED
  367.     LABEL  MEANING         BY MODEM COMMAND  RELATED ITEMS IN THIS GUIDE
  368.     ─────  ──────────────  ────────────────  ───────────────────────────
  369.     AA     Auto-Answer     ATS0=1            Search for (slash)DIP
  370.     MR     Modem Ready     AT&D1             Search for (slash)DIP
  371.     TR     Terminal Ready  N/A
  372.     OH     Off-hook        ATH0              Should be OFF, not on.
  373.  
  374.     LIGHT
  375.     LABEL  MEANING         COMMENTS
  376.     ─────  ──────────────  ────────────────────────────────────────────────
  377.     SD     Send            Should flash when modem  receives  your commands
  378.     RD     Read            Should flash when modem replies to your commands
  379.  
  380. 2.  If you have an internal modem, you still have to make the settings
  381.     correctly, but you won't see any lights to indicate if your commands
  382.     have been accepted.
  383.  
  384. ───────────────────────────────────────────────────────────────────────────────
  385.  
  386. KEYWORD:  /MODEM/ANSWER/CONNECTING/SPEED
  387. PROBLEM:  Modem answers incoming calls okay at some speeds but not at others.
  388.  
  389. 1.  In configuring your modem, you must take care to set the X setting (i.e.
  390.     the ATX command) properly.  For example, some settings may not show the
  391.     baud rate properly.  In general, use the highest X setting supported by
  392.     your modem.
  393.  
  394. 2.  If you are having trouble at baud rates of 9600 or more, you will have to
  395.     consult your modem manual.  A sample problem:  the other person might be
  396.     trying to connect an HST at 9600 to a V32 modem at 9600; the two methods
  397.     are not compatible.
  398.  
  399. 3.  Some modems, when initialized at 300 baud, can jump to 1200 baud, but
  400.     not to 2400.  In such case, try initializing the modem at 2400.
  401.  
  402. ───────────────────────────────────────────────────────────────────────────────
  403.  
  404. KEYWORD:  /MODEM/ANSWER/CONNECTING/SPEED/300
  405. PROBLEM:  Modem doesn't work properly on 300 baud calls
  406.  
  407. Some 9600 baud modems can't support the higher baud-rates and 300 baud at the
  408. same time.  Under some circumstance, the Telebit T1600 exhibits this behaviour.
  409. There is no way to fix this problem except to experiment with the modem's
  410. internal settings.  Be sure to record your modem's present settings before you
  411. start experimenting.
  412.  
  413.  
  414.  
  415. ▄█▀█▀█▀█▀█▀█▀█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█▀█▀█▀█▀█▀█▀█▄
  416. █▌▒■▒■▒■▒■▒■▒■                 = DISCONNECTING =                  ■▒■▒■▒■▒■▒■▒▐█
  417. ▀█▄█▄█▄█▄█▄█▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▄█▄█▄█▄█▄█▄█▀
  418.  
  419.  
  420. KEYWORD:  /MODEM/HANG UP/ECHO
  421. PROBLEM:  When user hangs up, modem endlessly echoes back to Sapphire.
  422.  
  423. Some modems don't have time to drop the carrier while characters are being
  424. sent.  For this reason, you have to configure the modem not to echo command
  425. characters.  This can cause an echoing loop when somebody hangs up.
  426.  
  427. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  428. | The solution given here applies to most modems, but check your modem manual |
  429. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  430. ┌·─·─·─·─·─·─·─·┬·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  431. |   MODEM HAS   |                                                             |
  432. | DIP SWITCHES? | ACTION TO BE TAKEN                                          |
  433. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  434. |     YES       | Set switch 4 to NOT echo characters                         |
  435. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  436. |     NO        | Include E0 - not E1 - in your modem initialization command  |
  437. └·─·─·─·─·─·─·─·┴·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  438.  
  439.  
  440.  
  441. ▄█▀█▀█▀█▀█▀█▀█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█▀█▀█▀█▀█▀█▀█▄
  442. █▌▒■▒■▒■▒■▒■▒■                 = MISCELLANEOUS =                  ■▒■▒■▒■▒■▒■▒▐█
  443. ▀█▄█▄█▄█▄█▄█▄█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█▄█▄█▄█▄█▄█▄█▀
  444.  
  445.  
  446. KEYWORD:  /MODEM/CARRIER
  447. PROBLEM:  Sapphire says that the modem is presenting a carrier.
  448.  
  449. You must set your modem so that it does NOT present a carrier -- unless some-
  450. body has dialed in and is connected.
  451.  
  452. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  453. | The solution given here applies to most modems, but check your modem manual |
  454. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  455. ┌·─·─·─·─·─·─·─·┬·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  456. |   MODEM HAS   |                                                             |
  457. | DIP SWITCHES? | ACTION TO BE TAKEN                                          |
  458. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  459. |     YES       | Set switch 6 to use CD line                                 |
  460. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  461. |     NO        | Try including &C1 in your modem initialization command      |
  462. └·─·─·─·─·─·─·─·┴·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  463.  
  464. ───────────────────────────────────────────────────────────────────────────────
  465.  
  466. KEYWORD:  /MODEM/NOT READY/READY
  467. PROBLEM:  Sapphire says that the modem is not ready.
  468.  
  469.  
  470. 1.  If you have an external modem, are all wires of the modem cable connected
  471.     properly?
  472.  
  473.     A.  If you have a "null modem cable" (pins 2 and 3 cross-connected)
  474.         Sapphire won't answer.
  475.  
  476.     B.  Using some wire, a flashlight battery, and a flashlight bulb as a
  477.         simple continuity tester, check that the important pins are connected
  478.         end-to-end:
  479.  
  480.         Pin 1 (or Pin 7)   Pin 2   Pin 3   Pin 8   Pin 20
  481.  
  482.         The pin numbers are usually written in tiny letters on one of the
  483.         connectors, or pin 1 is marked with a little arrow.
  484.  
  485. ···············································································
  486.  
  487. 2.  Make sure that the modem is configured to use the Terminal Ready line.
  488.  
  489. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  490. | The solution given here applies to most modems, but check your modem manual |
  491. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  492. ┌·─·─·─·─·─·─·─·┬·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  493. |   MODEM HAS   |                                                             |
  494. | DIP SWITCHES? | ACTION TO BE TAKEN                                          |
  495. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  496. |     YES       | Set switch 1 to use DTR line                                |
  497. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  498. |     NO        | Try including &D1 or &D2 in modem initialization command    |
  499. └·─·─·─·─·─·─·─·┴·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  500.  
  501. ···············································································
  502.  
  503. 3.  Make sure the modem's DSR behaviour is configured properly.
  504.  
  505. Some modems allow the selection of the behaviour of the Dataset Ready (DSR)
  506. signal.  The proper setting is "always on", but some modems let DSR indicate
  507. whether or not there is a carrier.
  508.  
  509. On modems without DIP switches, you can usually set DSR behaviour with the &S
  510. setting.  For example, on most Hayes modems, &S0 sets the corrects behaviour.
  511.  
  512. ───────────────────────────────────────────────────────────────────────────────
  513.  
  514. KEYWORD:  /MODEM/OK/AT COMMANDS
  515. PROBLEM:  The modem seldom or never responds "OK" to the commands I send it.
  516.  
  517. 1.  Try configuring the modem at a lower baud-rate -- it may be missing some
  518.     of the responses.  The initialization baud-rate is set via SYSOP:CONFIG.
  519.  
  520. 2.  If the problem happens only after you've used another modem-oriented
  521.     program, turn the modem off and on before starting Sapphire.  The method
  522.     by which some modems figure out their command baudrate may make it
  523.     impossible for Sapphire to reset the modem.
  524.  
  525.     Technical explanation:  Modems determine their command baudrate by looking
  526.     for an "AT" after a reset.  Some modems reset on a DTR transition; some
  527.     don't.  In such case, the easiest way to do a reset is to turn the modem
  528.     off and on.
  529.  
  530. ───────────────────────────────────────────────────────────────────────────────
  531.  
  532. KEYWORD:  /MODEM/DIP SWITCHES
  533. PROBLEM:  Modem has DIP switches.
  534.  
  535. Older modems have tiny DIP (dual-inline-package) switches (sometimes you have
  536. to open the modem to find the bank of switches).  In most cases, they are set
  537. as follows:
  538.  
  539. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  540. | The solution given here applies to most modems, but check your modem manual |
  541. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  542.  
  543.       Switch 1 UP:   Computer should use the Data Terminal Ready (DTR) line
  544.       Switch 2 UP:   Result codes sent as words
  545.       Switch 3 DOWN: Result codes are sent to the computer
  546.       Switch 4 UP:   Echo incoming characters
  547.       Switch 5 DOWN: Don't answer incoming calls
  548.       Switch 6 UP:   Computer should use the Carrier Detect (CD) line
  549.  
  550. These modems may also have switches 7 and 8; check your manual to see how
  551. they should be set.
  552.  
  553.  
  554.  
  555. ████████████████████████████████████████████████████████████████████████████████
  556. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  557. █░▒░▒░▒░▒░▒░▒▌                    == NOISE ==                     ▐▒░▒░▒░▒░▒░▒░█
  558. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  559. ████████████████████████████████████████████████████████████████████████████████
  560.  
  561.  
  562. KEYWORD:  /NOISE/RANDOM/CHARACTERS/GARBAGE/CONNECTING
  563. PROBLEM:  Users see some random characters when they connect.
  564.  
  565. 1.  If only one user has this problem, ask him to try on a different modem,
  566.     or to try from another location.
  567.  
  568. 2.  If everybody has this problem, disconnect ALL phones at your house (even
  569.     those on other lines) except the modem.  If this cures the problem, it
  570.     may indicate the problem.  Some conference phones, for example, cause
  571.     leakage between lines, which causes line noise.
  572.  
  573. 3.  If you have this problem during early testing, make sure that the other
  574.     person has called other BBS's before, at the baud rate being attempted,
  575.     and that the baud rate being attempted is within the capabilities of both
  576.     modems.
  577.  
  578. 4.  See also the CONNECTING items in the MODEM section.
  579.  
  580.  
  581.  
  582. ████████████████████████████████████████████████████████████████████████████████
  583. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  584. █░▒░▒░▒░▒░▒░▒▌               == PROGRAM FAILURE ==                ▐▒░▒░▒░▒░▒░▒░█
  585. █▒░▒░▒░▒░▒░▒░▌                                                    ▐░▒░▒░▒░▒░▒░▒█
  586. ████████████████████████████████████████████████████████████████████████████████
  587.  
  588.  
  589. KEYWORD:  /PROGRAM/FAILURE/ERROR CODE/RUNTIME ERROR/IO ERROR/BUG
  590. PROBLEM:  Program fails with an error code.
  591.  
  592. Call our BBS at 514-345-8654 and have a look around.  We may have a copy of
  593. SAPPHTS.DOC that covers your problem or a new version of SRUN.EXE that solves
  594. it.  If that doesn't help, call our voice support line at 514-345-9578.
  595.  
  596. If you think you've spotted a bug in Sapphire, the most helpful thing you can do
  597. is learn to make it happen on demand.  That is to say, before you report a
  598. problem, try to understand it well enough to make it happen on purpose.  Here's
  599. a checklist to help you assess the problem:
  600.  
  601.   1.   What do you think causes the problem?
  602.   2.   How often does it happen?
  603.   3.   Does it happen to everybody or just certain people?
  604.   4.   Did it start just recently or has it always happened?
  605.   5.   If it just started, what changed just before it started?
  606.   6.   What have you done to try to solve the problem?
  607.  
  608.